home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / bin / c64kerv22b.sda / KERMIT 6.DOC < prev    next >
Text File  |  2020-01-01  |  9KB  |  330 lines
  1.  
  2.  
  3.  
  4.  
  5. ╨AGE 30                         ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
  6.  
  7.  
  8.     ╬╧╬┼ (DEFAULT)   -   EIGHT DATA BITS AND NO
  9.                          PARITY BIT.
  10.  
  11.     ═┴╥╦             -   SEVEN DATA BITS WITH THE
  12.                          PARITY BIT SET TO ONE.
  13.  
  14.     ╙╨┴├┼            -   SEVEN DATA BITS WITH THE
  15.                          PARITY BIT SET TO ZERO.
  16.  
  17.     ┼╓┼╬   Ö         -   SEVEN DATA BITS WITH THE
  18.                          fARITY BIT SET Tf MAKE
  19.                          fHE OVERALL PARITY EVEN.f
  20.     ╧─f              -   SEVEN DATA BITS WITH THE
  21.                          PARITY BIT SET TO MAKE
  22.                          THE OVERALL PARITY ODD.
  23.  
  24.       ╙ET ╥ECEIVE
  25.  
  26. ╔T IS POSSIBLE TO SET VARIOUS PARAMETERS ASSOCIATED WITH THE
  27. RECEIVING OF DATA FROM THE ╦ERMIT ON THE OTHER END OF THE
  28. CONNECTION (THE REMOTE ╦ERMIT).  ╙┼╘ ╥┼├┼╔╓┼ WILL ENABLE YOU
  29. TO SET THE VARIOUS ╥ECEIVE PARAMETERS.  ╘HE FORMAT OF THIS
  30. COMMAND IS:
  31.  
  32. ╦ERMIT-65>SET RECEIVE <SUBOPTION>
  33.  
  34. ╘HE SUBOPTIONS OF THE ╙┼╘ ╥┼├┼╔╓┼ COMMAND ARE:
  35.  
  36.     ┼IGHT-BIT-QUOTE-CHAR   ┼ND-OF-LINE   ╨ACKET-LENGTH
  37.     ╨AD-CHAR               ╨ADDING       ╤UOTE-CHAR
  38.     ╘IMEOUT
  39.  
  40. ╘HESE SUBOPTIONS ARE DESCRIBED BELOW.
  41.  
  42.  
  43.         ╙ET ╥ECEIVE ┼IGHT-BIT-QUOTE-CHAR
  44.  
  45. ╘HIS COMMAND SETS THE CHARACTER TO BE USED TO QUOTE CHARAC-
  46. TERS WHEN ┼╔╟╚╘-┬╔╘ ╤╒╧╘╔╬╟ IS ╧╬.  ╘HE DEFAULT VALUE IS
  47. HEXADECIMAL 26 (DECIMAL 38, ┴╙├╔╔ "&").  ╨LEASE SEE ╙ET
  48. ┼IGHT-BIT-QUOTING FOR FURTHER INFORMATION.  ╘HE FORMAT OF
  49. THIS COMMAND IS:
  50.  
  51. ╦ERMIT-65>SET RECEIVE EIGHT-BIT-QUOTE-CHAR [VALUE]
  52.  
  53. WHERE [VALUE] IS THE ┴╙├╔╔ VALUE OF THE CHARACTER (IN HEX)
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ├-64/128 ╦ERMIT ╒SER'S ╟UIDE                         ╨AGE 31
  71.  
  72.  
  73. TO USE FOR EIGHT-BIT QUOTING.
  74.  
  75.         ╙ET ╥ECEIVE ┼ND-OF-LINE
  76.  
  77. ╘HIS COMMAND SETS THE END OF LINE CHARACTER THAT ├-64/128
  78. ╦ERMIT EXPECTS TO RECEIVE FROM THE REMOTE ╦ERMIT.  ╘HIS IS
  79. THE CHARACTER WHICH TERMINATES A PACKET OF DATA DURING FILE
  80. TRANSMISSION.  ╘HE DEFAULT VALUE IS HEXADECIMAL 0─ (┴╙├╔╔
  81. <├╘╥╠> - <═>, WHICH IS <╥┼╘╒╥╬>).  ╘HE FORMAT OF THIS COM-
  82. MAND IS:
  83.  
  84. ╦ERMIT-65>SET RECEIVE END-OF-LINE [VALUE]
  85.  
  86. WHERE [VALUE] IS THE ┴╙├╔╔ VALUE OF THE CHARACTER TO USE FOR
  87. THE END OF LINE CHARACTER (IN HEX).
  88.  
  89.         ╙ET ╥ECEIVE ╨ACKET-LENGTH
  90.  
  91. ╘HIS COMMAND SETS THE RECEIVE PACKET LENGTH.  ╘HE VALUE FOR
  92. THIS PARAMETER MUST BE BETWEEN HEXADECIMAL 0┴ (DECIMAL 10)
  93. AND $60 (DECIMAL 96).  ╨ACKET LENGTHS OUTSIDE OF THIS RANGE
  94. ARE ILLEGAL.  ╘HE DEFAULT VALUE IS $5┼ (94 DECIMAL).  ╘HE
  95. FORMAT OF THIS COMMAND IS:
  96.  
  97. ╦ERMIT-65>SET RECEIVE PACKET-LENGTH [VALUE]
  98.  
  99. WHERE [VALUE] IS THE ┴╙├╔╔ VALUE OF THE RECEIVE PACKET
  100. LENGTH (IN HEX).
  101.  
  102.         ╙ET ╥ECEIVE ╨AD-CHAR
  103.  
  104. ╘HIS PARAMETER IS THE PADDING CHARACTER THAT IS EXPECTED
  105. FROM THE REMOTE ╦ERMIT.  ╘HE PARAMETER MUST BE A HEX NUMBER
  106. BETWEEN 0 AND $1╞ OR $7╞.  ┴LL OTHER VALUES ARE ILLEGAL.
  107. ╘HE DEFAULT VALUE IS 0 (┴╙├╔╔ ╬╒╠).  ╘HE FORMAT OF THIS COM-
  108. MAND IS:
  109.  
  110. ╦ERMIT-65>SET RECEIVE PAD-CHAR [VALUE]
  111.  
  112. WHERE [VALUE] IS THE ┴╙├╔╔ VALUE OF THE CHARACTER TO BE USED
  113. AS A PAD CHARACTER (IN HEX).
  114.  
  115.         ╙ET ╥ECEIVE ╨ADDING
  116.  
  117. ╘HIS COMMAND SETS THE NUMBER OF PADDING CHARACTERS TO
  118. REQUEST BEFORE EACH PACKET COMING FROM THE OTHER ╦ERMIT.
  119. ╘HE DEFAULT VALUE IS 0.  ╘HE FORMAT OF THIS COMMAND IS:
  120.  
  121. ╦ERMIT-65>SET RECEIVE PADDING [VALUE]
  122.  
  123. WHERE [VALUE] IS THE NUMBER (IN HEX) OF PADDING CHARACTERS
  124. TO USE.  ╬╧╘┼: ╘HIS COMMAND, ALONG WITH ╙┼╘ ╥┼├┼╔╓┼ ╨┴─-
  125. ├╚┴╥, IS ONLY USED UNDER VERY UNUSUAL CIRCUMSTANCES.  ┴T
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ╨AGE 32                         ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
  137.  
  138.  
  139. THIS TIME, NO ╦ERMIT PROGRAM FOR ANY MACHINE IS KNOWN TO
  140. NEED PADDING, AND IF ONE DID, IT WOULD REQUEST IT WITHOUT
  141. INTERVENTION.
  142.  
  143.         ╙ET ╥ECEIVE ╤UOTE-CHAR
  144.  
  145. ╘HIS COMMAND SETS THE QUOTING CHARACTER THAT ├-64/128 ╦ERMIT
  146. WILL EXPECT ON INCOMING FILES.  ╘HIS IS THE CHARACTER USED
  147. TO QUOTE CONTROL CHARACTERS.  ╘HE DEFAULT VALUE IS $23
  148. (┴╙├╔╔ "#").  ╘HE FORMAT OF THIS COMMAND IS:
  149.  
  150. ╦ERMIT-65>SET RECEIVE QUOTE-CHAR [VALUE]
  151.  
  152. WHERE [VALUE] IS THE ┴╙├╔╔ VALUE OF THE QUOTING CHARACTER
  153. (IN HEX).
  154.  
  155.         ╙ET ╥ECEIVE ╘IMEOUT
  156.  
  157. ╘HIS COMMAND SETS THE NUMBER OF SECONDS THAT ├-64/128 ╦ERMIT
  158. WILL WAIT FOR ACKNOWLEDGEMENT BEFORE IT WILL RETRY SENDING
  159. OR RECEIVING THE CURRENT PACKET OF DATA (DURING A ╥┼├┼╔╓┼,
  160. ╙┼╬─, OR ╟┼╘).  ╘HE DEFAULT VALUE IS 15 SECONDS (HEX 0╞).
  161. ╘HE FORMAT OF THIS COMMAND IS:
  162.  
  163. ╦ERMIT-65>SET RECEIVE TIMEOUT [VALUE]
  164.  
  165. WHERE [VALUE] IS THE NUMBER OF SECONDS TO WAIT FOR A MESSAGE
  166. FROM THE REMOTE ╦ERMIT (IN HEX).
  167.  
  168.       ╙ET ╥╙232-REGISTERS
  169.  
  170. ╘HIS COMMAND SETS THE 2 ╥╙-232 REGISTERS IN THE ├-64/128
  171. THAT CONTROL THE BAUD RATE, PARITY, ETC.  ╘HE 2 REGISTERS
  172. ARE TREATED AS A 16 BIT HEX INTEGER.  ╘HE FIRST 2 DIGITS ARE
  173. THE ╙┼├╧╬─ REGISTER AND THE LAST 2 DIGITS ARE THE ╞╔╥╙╘
  174. REGISTER.  ╔F ONLY 2 DIGITS ARE ENTERED, THE SECOND REGISTER
  175. IS CLEARED.  ╘HE FORMAT OF THIS COMMAND IS:
  176.  
  177. ╦ERMIT-65>SET RS232-REGISTERS [VALUE]
  178.  
  179. WHERE [VALUE] IS A FOUR-BYTE LONG HEX INTEGER.  ╙OME EXAM-
  180. PLES:
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ├-64/128 ╦ERMIT ╒SER'S ╟UIDE                         ╨AGE 33
  203.  
  204.  
  205.     ╦ERMIT-65>SET RS232-REGISTERS 0006   SETS THE REGISTERS
  206.                                          TO 06, 00 FOR 300
  207.                                          BAUD, 8 BITS, NO
  208.                                          PARITY
  209.  
  210.     ╦ERMIT-65>SET RS232-REGISTERS A026   SETS THE REGISTERS
  211.                                          TO $26, $┴0 FOR 300
  212.                                          BAUD, 7 BITS, MARK
  213.                                          PARITY.
  214.  
  215. ╙EE THE ├OMMODORE 64 OR 128 ╨ROGRAMMER'S ╥EFERENCE ╟UIDES
  216. FOR A COMPLETE DESCRIPTION OF THE ╥╙-232 REGISTERS.  ╨LEASE
  217. NOTE THAT THIS COMMAND IS RARELY USED-- IT IS A HOLDOVER
  218. FROM THE EARLIEST VERSIONS OF ╦ERMIT.  ┘OU CAN USE THE ╙┼╘
  219. ┬┴╒─ AND ╙┼╘ ╨┴╥╔╘┘ COMMANDS TO SET THE BAUD AND PARITY FOR
  220. MOST CASES.  ╙EE THE ╦NOWN ╥ESTRICTIONS SECTION OF ┴PPENDIX
  221. ┴ FOR EXCEPTIONS.
  222.  
  223.       ╙ET ╙CREEN-DRIVER
  224.  
  225. ╘HIS COMMAND SWITCHES THE DISPLAY MODE.  ╦ERMIT IS CAPABLE
  226. OF DISPLAYING TEXT IN 40 AND 80 COLUMNS, USING THE ┬ATTERIES
  227. ╔NCLUDED ┬╔-80 80 COLUMN CARD, AND ALSO USING THE ├OMMODORE
  228. 128'S 80 COLUMN SCREEN.  ╬OT ALL OF THE DISPLAYS ARE CAPABLE
  229. OF COMPLETELY ACCURATE DISPLAYS.  ╞OR EXAMPLE, THE STANDARD
  230. ┬ATTERIES ╔NCLUDED 80 COLUMN CHARACTER SET DOES NOT INCLUDE
  231. CERTAIN STANDARD ┴╙├╔╔ CHARACTERS.  ╔N ALL CASES THE BEST
  232. COMPROMISE WAS MADE TO PROVIDE THE MOST ACCURATE DISPLAY
  233. (╨LEASE SEE THE ╙CREEN ─RIVER ├OMPARISON SECTION FOR FURTHER
  234. INFORMATION).  ╘HE FORMAT OF THIS COMMAND IS:
  235.  
  236. ╦ERMIT-65>SET SCREEN-DRIVER [KEYWORD]
  237.  
  238. WHERE [KEYWORD] IS 40-├╧╠╒═╬╙, 80-├╧╠╒═╬╙, ┬╔-80,
  239. ├╧══╧─╧╥┼-128, OR ├╒╙╘╧═-┬╔-80.
  240.  
  241.       ╙ET ╙END
  242.  
  243. ╔T IS POSSIBLE TO SET VARIOUS PARAMETERS ASSOCIATED WITH THE
  244. SENDING OF DATA TO THE REMOTE ╦ERMIT.  ╙┼╘ ╙┼╬─ ENABLES YOU
  245. TO SET THE VARIOUS ╙┼╬─ PARAMETERS.  ╘HESE PARAMETERS SHOULD
  246. NOT NORMALLY BE CHANGED SINCE, AS PART OF THE TRANSFER INI-
  247. TIALIZATION PROCESS, THE TWO ╦ERMITS EXCHANGE THEIR ╥┼├┼╔╓┼
  248. PARAMETERS.  ╘HE CAPABILITY OF SETTING THESE PARAMETERS IS
  249. PROVIDED SO THAT THE TRANSFER INITIALIZATION CAN BE COM-
  250. PLETED EVEN IF THE DEFAULT PARAMETERS ARE NOT CORRECT.  ╘HE
  251. FORMAT OF THIS COMMAND IS:
  252.  
  253. ╦ERMIT-65>SET SEND <SUBOPTION>
  254.  
  255. ╘HE SUBOPTIONS OF THE ╙┼╘ ╙┼╬─ COMMAND ARE:
  256.  
  257.     ┼IGHT-BIT-QUOTE-CHAR   ┼ND-OF-LINE   ╨ACKET-LENGTH
  258.     ╨AD-CHAR               ╨ADDING       ╤UOTE-CHAR
  259.     ╘IMEOUT
  260.  
  261. ╘HE SUBOPTION DESCRIPTIONS FOR THE ╙┼╘ ╙┼╬─ COMMAND ARE THE
  262. SAME AS THOSE FOR THE ╙┼╘ ╥┼├┼╔╓┼ COMMAND (EXCEPT THAT THEY
  263. AFFECT SENDING, NOT RECEIVING, PARAMETERS). ╙O, TO AVOID
  264.  
  265.  
  266.  
  267.  
  268. ╨AGE 34                         ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
  269.  
  270.  
  271. REDUNDANCY, PLEASE REFER TO THE APPROPRIATE SUBOPTION
  272. DESCRIPTIONS UNDER THE ╙ET ╥ECEIVE SECTION FOR FURTHER
  273. INFORMATION.
  274.  
  275.       ╙ET ╘ERMINAL-EMULATION
  276.  
  277. ╦ERMIT IS CAPABLE OF EMULATING TWO POPULAR TERMINALS, AS
  278. WELL AS ACT AS A DUMMY (GLASS) TERMINAL.  ╘HE ╙┼╘ ╘┼╥═╔╬┴╠-
  279. ┼═╒╠┴╘╔╧╬ COMMAND CHANGES THE TYPE OF TERMINAL ╦ERMIT EMU-
  280. LATES.  ╘HE FORMAT FOR THIS COMMAND IS:
  281.  
  282. ╦ERMIT-65>SET TERMINAL-EMULATION [TYPE]
  283.  
  284. WHERE [TYPE] IS ╬╧╬┼, ╓╘-52, OR ╓╘-100.  ╦ERMIT PROVIDES
  285. VERY ACCURATE EMULATION OF THE ─┼├ ╓╘-52 AND ╓╘-100 TERMI-
  286. NALS.  ╔N ╓╘-100 MODE, ╦ERMIT CAN PERFORM MOST ALL FUNCTIONS
  287. OF A ╓╘-100 TERMINAL, INCLUDING DISPLAYING A GRAPHICS CHAR-
  288. ACTER SET AS WELL AS EMULATING CERTAIN ╓╘-102 SEQUENCES.
  289. ╙EE ╘ERMINAL-╘YPE ╞EATURES FOR MORE INFO.
  290.  
  291.       ╙ET ╫ORD-SIZE
  292.  
  293. ╘HIS OPTION SETS THE DATA WORD LENGTH FOR COMMUNICATION WITH
  294. ANOTHER COMPUTER.  ┴LTHOUGH WORD LENGTHS BELOW SEVEN BITS
  295. EXIST, ├-64/128 ╦ERMIT ONLY SUPPORTS SEVEN AND EIGHT BIT
  296. WORD LENGTHS.  ╘HE FORMAT OF THIS COMMAND IS:
  297.  
  298. ╦ERMIT-65>SET WORD-SIZE [LENGTH]
  299.  
  300. WHERE [LENGTH] IS EITHER ╙┼╓┼╬-┬╔╘ OR ┼╔╟╚╘-┬╔╘.
  301.  
  302.     ╙HOW
  303.  
  304. ╘HE ╙╚╧╫ COMMAND ALLOWS YOU TO EXAMINE THE STATUS OF MANY OF
  305. THE ╙┼╘ PARAMETERS.  ╘HE FORMAT IS:
  306.  
  307. ╦ERMIT-65>SHOW <OPTION> <SUBOPTION>...
  308.  
  309. ╘HE OPTIONS AVAILABLE TO ╙╚╧╫ ARE:
  310.  
  311.     ┴LL                  ┬AUD              ─EBUGGING
  312.     ┼IGHT-BIT-QUOTING    ┼SCAPE            ╞ILE-BYTE-SIZE
  313.     ╞ILE-TYPE            ╞ILE-WARNING      ╞LOW-CONTROL
  314.     ╔┬═                  ╠OCAL-ECHO        ╨ARITY
  315.     ╥ECEIVE              ╥╙232-╥EGISTERS   ╙END
  316.     ╘ERMINAL-EMULATION   ╫ORD-SIZE
  317.  
  318. ╘HE ╙╚╧╫ ┴╠╠ COMMAND WILL DISPLAY THE SETTINGS FOR MOST OF
  319. THE PARAMETERS THAT MAY BE ╙┼╘.  ╘HE OTHER ╙╚╧╫ OPTIONS AND
  320. SUBOPTIONS WILL DISPLAY THE CURRENT VALUE OF JUST THAT PAR-
  321. TICULAR PARAMETER.  ╬OTE: ╘HE 4 COLOR COMMANDS AND THE
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.